4ZIP/4UNZIP USER'S GUIDE DECEMBER 1991 _______ ____|__ | (tm) --| | |------------------- | ____|__ | Association of | | |_| Shareware |__| o | Professionals -----| | |--------------------- |___|___| MEMBER Iram J. Weinstein XD SYSTEMS 1014 SHIPMAN LANE MCLEAN, VA 22101 CONTENTS Limited Warranty 1 Background 2 4ZIP Usage 2 4UNZIP Usage 5 Extended Descriptions 5 Regarding Registration 6 4ZIP/4UNZIP Version History 7 4EDIT 8 Software Registration Form and Order 9 LIMITED WARRANTY XD Systems warrants the physical diskette enclosed herein to be free of defects in materials and workmanship for a period of 60 days from the date of purchase. In the event of notification within the warranty period of defects in material or workmanship, XD Systems will replace the defective diskette. XD Systems specifically disclaims all other warranties, express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose. In no event shall XD Systems be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential or other damages arising out of the use, the result of use, or inability to use this product. This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or send a Compuserve message via easyplex to ASP Ombudsman, 70007,3536. The ombudsman may also be contacted by FAX by sending to the ASP FAX number: (616) 788-2765. In communication with the Ombudsman, please include a telephone number and/or FAX if possible. 4DOS is a trademark of J.P. Software. PKZip and PKUnzip are trademarks of PKWare. 4ZIP, 4UNZIP and all the files and documentation distributed with them are copyright 1990,1991 by Iram J. Weinstein. All rights reserved. -1- 4ZIP/4UNZIP User's Guide Copyright (C) 1990, 1991 I. J. Weinstein A.BACKGROUND 4DOS provides a way of attaching descriptions to files on your disk that is apparently seamless. The descriptions appear on directory displays and automatically are copied when you COPY or MOVE a file to another disk or directory. But this seamless property fails as soon as you use other programs on your files. For example, if you archive the files with the PKware programs PKZIP or PKUNZIP, the descriptions stay behind. 4ZIP and 4UNZIP address this problem, providing an automatic method to store descriptions in ZIPFiles and to restore them when you extract a file. You should know that the DESCRIPT.ION file is a hidden file. You will not see it in the DOS directory unless you change the file attribute or use the 4DOS DIR /h option. You must have copies of the PKware utilities located on the DOS Path, or in the current directory. These shareware programs are not supplied with 4ZIP/4UNZIP. You can obtain them from many Shareware distributors, BBS's or from PKware directly at: PKware Inc. 7545 North Port Washington Road Glendale, WI 53217 XD Systems is not affiliated with PKware in any way. B. 4ZIP USAGE 4ZIP Usage is: 4ZIP ZIPFILE [Options] [d:][path][filespec] [filespec] [..] ***OPTIONS*** /a ZIP all files matching filespecs without query /m Move selected files from source directory to the ZIPFILE /odeinsu Order by Date created Ext descrIption Name Size Unsorted {-bekoqs!3$} Pass these commands on to PKZIP A directory display similar to that of SELECT will appear showing all of the files meeting any of the filespecs. This use of include lists is like the 4DOS DIR and SELECT usage. Filespecs can freely use the wildcard characters '*' and '?'. For example the filespecs c:\wp\*smith*.*; *. xyz would display all the files in the c:\wp directory that either have the letters smith in the name part or have xyz as the extension. Note that only the first argument in an include list can have a pathname; subsequent arguments default to the 2 same path. Filespecs in an include list can be separated by ';', as in 4DOS, or, for convenience, '+' or ' '. You can mark files to be ZIPped into ZipFile in several ways, using the keyboard or mouse, similar to the 4DOS SELECT command, as follows: Mark <+> UnMark <-> Toggle Toggle All <*> Begin Block End Block To move the selection bar around the list of files, use the cursor, the mouse, or the following keys: Up one line Down one line Up one full screen Down one full screen To top of list To bottom of list Additional functions are: Display Help screens ZIP marked files into ZIPFILE Quit 4ZIP without doing anything 1.Options a. Sorting 4ZIP will allow you to control the order in which files are displayed and zipped. The syntax is: /o[deinsu] Order by Date created Ext descrIption Name Size Unsorted b.International Date and Time 4ZIP/4UNZIP now is consistent with your country=xxx command in config.sys. Commandline overrides for the time format are provided. They are: /24 Use 24 hour time /12 Use 12 hour time (e.g., 10:35p) 4ZIP has two options which can be used singly or together, e.g., /a /m, or /am. 3 /a ZIP all files matching filespecs without query. 4ZIP Junk /a C:\SOURCE\*.Pas + *MATH*.INC would ZIP into JUNK.ZIP all files from the C:\SOURCE directory that either had the extension PAS or the extension INC and MATH anywhere in the filename. /m Move selected files from source directory to the ZIPFile. This works by deleting the files from the source directory after ZIPping. c. PKZIP Command Options 4ZIP will accept the following subset of the PKZIP commands and will pass them on to PKZIP: 'b', 'e', 'k', 'o', 'q', 's','!','3','$'. You'll have to read the PKZIP documentation to learn the meaning of these options. To pass commands to PKZIP, just enclose them in curly brackets anywhere on the 4ZIP command line. For example: 4ZIP myfiles {-o -es -!} *.txt or 4ZIP myfiles {-o} *.txt { -es -!} would both pass the commands -o -es -! to PKZIP. Some of the other PKZIP commands (e.g., '@', or 'f') are not compatible with 4ZIP and would mess up the tracking between files and their descriptions. 4ZIP will ignore these options if you try to use them. IF you use a PKZIP configuration file, make sure that you do not try to pass commands that would not be acceptable on the 4ZIP command line, as unpredictable results will occur, mainly mismatching descriptions with the files. d. Help Key F1 The help screens are displayed anytime F1 is pressed. Running 4ZIP with an error on the command line automatically invokes the help display. 4 C. 4UNZIP USAGE 4UNZIP Usage is: 4UNZIP ZIPFILE [Options] [outpath] [d:][path][filespec] [..] The display is similar to the 4ZIP display, showing all the files in the ZipFile that meet any of the filespecs. Marking of the files to be extracted and cursor movement around the screen is identical to 4ZIP. 4UNZIP has several options. The first two are similar to the ones provided for 4ZIP. /a UNZIP all files matching filespecs without query. /m Move selected files from the ZIPFile to the outpath directory (Current directory is default). /d Delete selected files from the ZIPFile without extracting. This provides a convenient tool for ZipFile management, allowing you to select files to be removed using any combination of filespecs with wild cards and the SELECT screen. The combination /ad will delete all the specified files without presenting the SELECT screen. The combination /md is interpreted the same as /m alone. Outpath, if supplied, determines the directory in which the extracted files are to be placed. So for example 4UNZIP C:\SOURCE\JUNK A:\ /am *.doc would extract all of the files with extension doc from the file C:\SOURCE\JUNK.ZIP and place them in the root directory of the A: drive. Then it would delete all of these files from JUNK.ZIP. 4UNZIP also accepts a subset of the PKUNZIP commands, using the same syntax as 4ZIP. The commands that 4UNZIP will recognize are: 'c', 'p', 'q', 's'. D. EXTENDED DESCRIPTIONS 4DOS 4.0 has capacity for descriptions up to 80 characters in length, and has a system for developers to extend the des- criptions to even greater lengths or to store other file- related information. However, the PKZIP comment format has room for only 59 characters. 4ZIP and 4UNZIP are designed to save and restore file descriptions up to the full length of 80 characters, and will also capture and restore any extended description fields if present. This all happens automatically. How it's done -- The PKZIP directory structure allows for file descriptions of only 59 characters. If all the Zipped files have descriptions that will fit and there are no extended fields in their 5 descript.ion entries, then the descriptions are stored in the PKZIP file directory, as in previous versions of 4ZIP. Otherwise, truncated descriptions are stored in the PKZIP directory, so they can be seen without 4UNZIP, and a special file with name 4ZIP_xxx.xxx (where the x'es are random letters) is added to the ZipFile, containing the full descript.ion entries. If the ZipFile is added to, more than one of these files may be present. You will see these files listed on the screen by PKZIP, but otherwise you should ignore them. E. REGARDING REGISTRATION 4ZIP/4UNZIP is ShareWare. The law requires that if you use this program, you must register and obtain a license for it. The registration fee is $15. A registration form is included at the end of this manual. Registered users will be notified of upgrades to 4ZIP/4UNZIP as they are released, and will receive the latest version of the program. Online help is available through CompuServe, by EasyPlex. Help is also available by mail. I will try to answer all letters within 48 hours. Non-registered users must include a SASE for a reply. The degree of help available to non-registered users is purely discretionary. Registrations and inquiries should be sent to: Iram J. Weinstein XD Systems 1014 Shipman Lane McLean, VA 22101 Voice (703) 821-3215 CIS 70741,3711 Commercial use of 4ZIP/4UNZIP without payment of the reg- istration fee is prohibited. Site licenses are available for users with multiple machines. Please contact me for information. The program and its associated documentation are the copyrighted property of the author. Non-commercial users are granted the right to use copy and share 4ZIP/4UNZIP with the following conditions: Shareware distributors and Users Groups may charge a nominal fee for copying and distributing this program and Bulletin Board Systems may likewise carry it. Any distribution of 4ZIP/4UNZIP must include without alteration only the files listed: 4ZIP.EXE, 4UNZIP.EXE and 4ZIP.TXT, unchanged. Permission is also given for electronic distribution of archived versions of these files on electronic bulletin boards. 6 F. 4ZIP/4UNZIP VERSION HISTORY Ver 0.90 (Beta Test) 12/01/89 This is the original release. It used batch files to drive 4ZIP and 4UNZIP and could only run under 4DOS. Ver 0.91 (Beta Test) 12/20/89 4ZIP and 4UNZIP now stand alone, and can be run under DOS. 4UNZIP accesses the ZipFile Directory itself without using PKZIP -v. This is much faster. Ver 0.92 (Beta Test) 1/21/90 Improved exception handling for DOS errors. Added /d and /m options to 4UNZIP Allow specification of destination path for the extracted files in 4UNZIP Ver 0.93 (Beta Test) 2/04/90 1. Changed mark/unmark in 4ZIP and 4UNZIP to be more like the latest SELECT. Space bar toggles mark and * marks all. 2. 4ZIP lost descriptions on some files in big directories. Now fixed. 3. Ver 0.92 of 4ZIP tried to correct command line parser so that C: ==> C:*.* and ABC ==> ABC\*.* if ABC is a directory but ABC.* otherwise. Got it right this time! Version 1.0 3/11/90 First public release Version 1.01 3/21/90 1. Corrected error (shame on me) in 4UNZIP that included  marker in filename. 2. Corrected 4UNZIP error when destination path is not source path. 3. Minor changes in documentation. Version 1.02 3/23/90 Corrected error in 4ZIP and 4UNZIP - not properly recognizing include lists. Version 1.03 4/01/90 Changed file access to run on networks reliably. Added name and serial number on registered copies. Version 1.04 6/10/90 Modified to correct for 4DOS 3.0 quirk. Entries in DESCRIPT.ION are sometimes delimited by LF instead of CRLF. Earlier versions of 4ZIP/4UNZIP misread these lines. Corrected 4ZIP/4UNZIP to properly access ZIPfiles smaller than 150 bytes. Version 1.05 7/15/90 Corrected error that caused -a option of 4UNZIP to lose descriptions. 7 Version 1.06 8/03/90 Added Error Messages for Drive unready and Disk write-protected. 4ZIP JUNK a: is now equivalent to 4ZIP JUNK a:*.* Version 1.07 9/16/90 4UNZIP choked on the long ZipFile comments now being added by some BBS operators. Modified to correct this. Version 1.08 10/18/90 4UNZIP occasionally dropped file descriptions if the file had an 8 character name and a 3 character extension. This is corrected. A problem with include lists that caused the same file to be selected more than once has been corrected for both programs. For example, 4ZIP test *.txt+4*.txt would show the file 4zip.txt twice. Version 1.09 6/22/91 4ZIP would prevent PKZIP from updating an existing ZIPFile if the DOS SHARE program was loaded. This is corrected. Version 2.0 10/13/91 This is an extensive revision, including Help key, mouse compatibility, Passthrough of PKZIP and PKUNZIP options, sorting of the display in 4ZIP, and International dates and time. Version 2.01 12/14/91 Both 4ZIP and 4UNZIP set the display blinking attribute off and did not restore it. This is now fixed. 4UNZIP occasionally lost descriptions existing in a directory. Also fixed. G. 4EDIT In 1988, I wrote and distributed a shareware program, XDIR, which was one of the first DOS directory programs to attach a comment to each file. When I first saw 4DOS, I loved it, but I wanted to have the same sort of full-screen editor for directory comments (or, in 4DOS terms, Descriptions) that I had in XDIR. 4EDIT provides this feature. I think you will find it very useful. Its good practice to comment your files, and often it is handy to see the descriptions attached to other files, while you are writing a new one. The 4EDIT package is shareware, available on Bulletin Boards, CompuServe, and from shareware distributors. Registration is $15. See the order form at the end of this manual. 8 SOFTWARE REGISTRATION FORM AND ORDER Check all that apply: [ ] 4ZIP/4UNZIP registration _____ @ $15.00 [ ] 4EDIT registration _____ @ $15.00 Postage and Handling $3.00 TOTAL ENCLOSED: $______ If you already have copies of the programs you are ordering , where were they obtained? [ ]CompuServe [ ]Friend [ ]Employer [ ]BBS ______________________ [ ]ShareWare Distributor________________________________________ Payment is by check [ ] or money order [ ] (Sorry - no COD or charges) Foreign Customers - Use $US check drawn on US Bank or Postal Money Order. NAME ___________________________________________ COMPANY ___________________________________________ ADDRESS ___________________________________________ CITY ___________________________________________ STATE __________________________ZIP _____________ Send your registration form and payment to: XD Systems 1014 Shipman Lane McLean, VA 22101 ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 4,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.